Skip to content

Conversation

DeveloperViraj
Copy link

Fixes #8045

Summary

This PR clarifies the Escape Hatches documentation by marking one example as intentionally problematic and suppressing the linter in the sandbox.

  • Added a note explaining that the options object example in Removing Effect dependencies is expected to show a linter error.
  • Suppressed the react-hooks/exhaustive-deps warning inline so the sandbox still runs without noise.

Why

  • The previous example looked like a bug rather than a teaching tool.
  • This change makes it clear to readers that the linter error is intentional, avoiding confusion.

Changes

  • Updated src/content/learn/escape-hatches.md

Testing

  • Docs-only change, verified sandbox still works as intended.

Copy link

github-actions bot commented Oct 3, 2025

Size changes

📦 Next.js Bundle Analysis for react-dev

This analysis was generated by the Next.js Bundle Analysis action. 🤖

🎉 Global Bundle Size Decreased

Page Size (compressed)
global 110.53 KB (-8 B)
Details

The global bundle is the javascript bundle that loads alongside every page. It is in its own category because its impact is much higher - an increase to its size means that every page on your website loads slower, and a decrease means every page loads faster.

Any third party scripts you have added directly to your app using the <script> tag are not accounted for in this analysis

If you want further insight into what is behind the changes, give @next/bundle-analyzer a try!

Five Pages Changed Size

The following pages changed size from the code in this PR compared to its base branch:

Page Size (compressed) First Load
/404 128.07 KB (-5 B) 238.6 KB
/500 128.08 KB (-5 B) 238.61 KB
/[[...markdownPath]] 130.52 KB (-5 B) 241.05 KB
/errors 128.32 KB (-5 B) 238.85 KB
/errors/[errorCode] 128.3 KB (-5 B) 238.83 KB
Details

Only the gzipped size is provided here based on an expert tip.

First Load is the size of the global bundle plus the bundle for the individual page. If a user were to show up to your website and land on a given page, the first load size represents the amount of javascript that user would need to download. If next/link is used, subsequent page loads would only need to download that page's bundle (the number in the "Size" column), since the global bundle has already been downloaded.

Any third party scripts you have added directly to your app using the <script> tag are not accounted for in this analysis

Next to the size is how much the size has increased or decreased compared with the base branch of this PR. If this percentage has increased by 10% or more, there will be a red status indicator applied, indicating that special attention should be given to this.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Linter breaks example for escape hatches
1 participant